home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / keyb / ptm229i.zip / README.1ST < prev    next >
Text File  |  1994-02-09  |  26KB  |  656 lines
  1.  
  2. DOS PHANTOM V2.9h from P2 Enterprises
  3.  
  4.     **********************************************************************
  5.     **  See the CHANGES IN V2.9 section of this file for new features.  **
  6.     **********************************************************************
  7.  
  8.  
  9.     DOS Phantom is a keystroke record-and-playback utility. Recordings
  10.     can be of any length and can be edited after recording.  Recordings
  11.     can be played back at high speed or with delays.  Playback can be
  12.     scheduled for a time in the future or invoked with a hot key. A
  13.     powerful script language is provided which incorporates file I/O,
  14.     looping and branching, waiting for screen text, branching on program
  15.     exit status, file I/O, pop-up windows and menus, and more.
  16.  
  17.                _______
  18.               ____|__     |               (tm)
  19.            --|       |    |-------------------
  20.              |   ____|__  |  Association of
  21.              |  |       |_|  Shareware
  22.              |__|   o   |    Professionals
  23.            -----|   |   |---------------------
  24.             |___|___|    MEMBER
  25.  
  26. INSTALLATION:
  27.  
  28.     Create a directory and unzip the PTM229.ZIP file into it.
  29.  
  30.     Example:
  31.           C:\> MKDIR PHANTOM
  32.           C:\> CD PHANTOM
  33.           C:\PHANTOM> PKUNZIP ..\PTM229
  34.  
  35.  
  36.     If you have the PTM.EXE self-extracting archive file, do this
  37.     instead:
  38.           C:\> MKDIR PHANTOM
  39.           C:\> CD PHANTOM
  40.           C:\PHANTOM> ..\PTM
  41.  
  42. DEMONSTRATION:
  43.  
  44.     Make sure you are in the directory containing the PHANTOM2.EXE and
  45.     DEMO files.  Then, type PHANTOM2 DEMO to run the demonstration.
  46.  
  47.     Now read the section in the PHANTOM.DOC file entitled "Before You
  48.     Start" for more installation information.
  49.  
  50.  
  51. REGISTRATION:
  52.  
  53.     When you register, P2 Enterprises will send you a free DOS Phantom
  54.     Quick Reference booklet.  This booklet contains just about every-
  55.     thing you need to use DOS Phantom without cracking the manual!
  56.     
  57.     You can register using Visa or MasterCard if you wish.
  58.  
  59.     See the file ORDER.FRM in this kit.
  60.  
  61.  
  62. DOS Phantom is:
  63.     - A task automation tool
  64.     - A tool for application integration (the process of making a
  65.     group of different applications work together automatically)
  66.     - A tool for creating self-executing demos (with looping and
  67.     timeout features)
  68.     - A software testing tool (including screen and print capture)
  69.     - A substitute for .BAT files
  70.     - A keystroke macro utility
  71.  
  72. DOS Phantom recordings can be edited to include:
  73.     - Pop-up text windows
  74.     - Pop-up menus
  75.     - Pauses for user input
  76.     - Branching based on:
  77.     - menu selection
  78.     - program exit status
  79.     - appearance of a text string on the screen
  80.     - String variables
  81.     - Commands to find, read, and write text files
  82.     - Looping
  83.     - Play music
  84.  
  85. DOS Phantom recordings can be scheduled for playback
  86.     - daily
  87.     - weekly
  88.     - once only
  89.  
  90. DOS Phantom recordings can also be played back using hot keys.
  91.  
  92. The included Scraper utility allows you to take output displayed by
  93. one program and play it into another program as if it were being typed
  94. at the keyboard.  And the use of Scraper can be recorded like any other
  95. keyboard activity.
  96.  
  97. DOS Phantom provides facilities similar to the scripting languages of
  98. popular communications programs such as Procomm and CrossTalk, but
  99. applied instead to *your* computer rather than the one you are connected
  100. to over the phone line.  You can even use DOS Phantom to control a
  101. Procomm session instead of using Procomm's scripting facility.
  102.  
  103. A demonstration recording and complete Users Guide are included.
  104. DOS Phantom is shareware.  The registration fee is $40.00.  All features
  105. are present and active in the shareware version.
  106.  
  107.  
  108. CHANGES FROM PREVIOUS VERSIONS
  109.  
  110.    Version 2.1 of DOS Phantom fixes a bug introduced in V2.0 which
  111.    prevented ALT and CTRL keys from playing back correctly into some
  112.    application programs, including CIM (CompuServe Information Manager).
  113.  
  114.    Version 2.2 is a redistribution of V2.1 which corrects the fact that
  115.    obsolete versions of the TXT2PTM and PTM2TXT programs were included
  116.    in PTM221.ZIP.
  117.  
  118.    Version 2.3 adds support for the PHANTOMDIR environment variable, and
  119.    support for scheduled playback and hot-key initiated playback with
  120.    the programs SCHEDULE and HOTFILE.
  121.  
  122.    Version 2.4 fixes two bugs reported just after version 2.3 was released.
  123.    Version 2.4 of PTM2TXT fixed a bug which caused the timings of certain
  124.    keystrokes (those with scan codes under 10h) to be set to zero.  Version
  125.    2.4 of PHANTOM2 fixes a problem where keystrokes were missed during
  126.    auto-repeat with typematic rates set above 15.  Minor changes were made
  127.    to the documentation.
  128.  
  129.    V2.4 also introduces the MAKEPTM program for producing DOS Phantom
  130.    recordings from plain ASCII text files.
  131.  
  132.    V2.5 fixes a bug in MAKEPTM which prevented processing files without
  133.    at least a 1 second line delay and incorporates changes to allow chaining
  134.    to another recording during playback.
  135.  
  136.    V2.6 adds support for the F11 and F12 keys and their SHFT, CTRL, and ALT
  137.    variants and fixes a bug which caused the schedule to be corrupted when
  138.    the default RECORDNG.PTM file was used for recording.
  139.  
  140.    V2.8 replaces the keyboard NumLock, ScrollLock, CapsLock, and Insert
  141.    keys to their pre-playback state when recording terminates unless
  142.    the $RetainKybdFlags directive is contained in the playback file.
  143.    (The $RetainKybdFlags directive has no arguments and may be placed anywhere
  144.    in the playback file.)  V2.8 also fixes a bug which caused scheduled
  145.    playbacks with days or dates specified other than the first in the list
  146.    to be ignored.
  147.  
  148.    V2.8A of PHANTOM2.EXE correctly reports errors when invalid hot key
  149.    combinations are specified.
  150.  
  151.    V2.8B of PHANTOM2.EXE correctly processes unused extended keyboard codes
  152.    (actually used by some products) which previously caused erroneous
  153.    directive processing to occur.
  154.  
  155.    V2.8C fixes a bug in which the use of ALT and CTRL hot keys with HOTFILE
  156.    caused keyboard to appear dead when playback completed.
  157.     
  158.    V2.8A of TXT2PTM.EXE correctly processes delays specified as MM:SS.CCC.
  159.    V2.8 incorrectly processed time delays of over approximately 5 minutes.
  160.  
  161.    V2.8A PTM2TXT.EXE correctly processes unused extended key codes and
  162.    their translation as <?>.
  163.  
  164.  
  165. CHANGES IN V2.9
  166.  
  167.    V2.9 adds support for the $DisableCtrlAltDel, $EnableCtrlAltDel, and
  168.    $Reboot directives which allow you to reboot the computer from a
  169.    Phantom playback and prevent Ctrl-Alt-Del from rebooting the computer
  170.    during critical sections of a playback.
  171.  
  172.    The $DisableKybd directive disables all keyboard input.  $Enablekybd
  173.    re-enables keyboard input.  An optional parameter of $DisableKybd is
  174.    a single key which, when depressed, will re-enable the keyboard.  Valid
  175.    keys for the $DisableKybd parameter are letters and numbers only. This
  176.    is to allow $DisableKybd to be used in situations it is desired to
  177.    protect against inadvertant key depressions, but where it is necessary
  178.    to re-enable the keyboard manually.
  179.  
  180.    The new $Sleep directive behaves just like the $Pause directive, except
  181.    that the timer is not reset after each keystroke as it is with $Pause.
  182.    $Sleep has one parameter, the number of seconds to sleep.  The maximum
  183.    number of seconds for all directives which accept seconds is 3600 (1 hr).
  184.  
  185.    The commands $MatchAt, $MatchTo, and $MatchFrom have been added.
  186.  
  187.    The syntax of the new Match commands is:
  188.     $MatchAt r,c n text
  189.     $MatchTo r,c n text
  190.     $MatchFrom r,c n text
  191.  
  192.     where r,c is the row and column number (1,1 is the upper left corner)
  193.     n is the timeout is seconds
  194.     text is text to match
  195.  
  196.     $MatchAt only looks for the text at the row and column specified.
  197.     The text must begin at that screen position for the match to succeed.
  198.     $MatchAt accepts -1 as the timeout value.  This results in a single
  199.     test of the screen location (effectively a timeout of zero).  A
  200.     timeout of -1 may not be used with the other $Match directives.
  201.  
  202.     $MatchTo searches for the text anywhere before (up and left of) the
  203.     row a